home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / X11 / XSetFontPath.z / XSetFontPath
Encoding:
Text File  |  1998-10-30  |  4.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSeeeettttFFFFoooonnnnttttPPPPaaaatttthhhh((((3333XXXX11111111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))  XXXXSSSSeeeettttFFFFoooonnnnttttPPPPaaaatttthhhh((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XSetFontPath, XGetFontPath, XFreeFontPath - set, get, or
  10.           free the font search path
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           XSetFontPath(_d_i_s_p_l_a_y, _d_i_r_e_c_t_o_r_i_e_s, _n_d_i_r_s)
  14.                 Display *_d_i_s_p_l_a_y;
  15.                 char **_d_i_r_e_c_t_o_r_i_e_s;
  16.                 int _n_d_i_r_s;
  17.  
  18.           char **XGetFontPath(_d_i_s_p_l_a_y, _n_p_a_t_h_s__r_e_t_u_r_n)
  19.                 Display *_d_i_s_p_l_a_y;
  20.                 int *_n_p_a_t_h_s__r_e_t_u_r_n;
  21.  
  22.  
  23.           XFreeFontPath(_l_i_s_t)
  24.                 char **_l_i_s_t;
  25.  
  26.  
  27.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  28.           _d_i_r_e_c_t_o_r_i_e_s
  29.                     Specifies the directory path used to look for a
  30.                     font.  Setting the path to the empty list restores
  31.                     the default path defined for the X server.
  32.  
  33.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  34.  
  35.           _l_i_s_t      Specifies the array of strings you want to free.
  36.  
  37.           _n_d_i_r_s     Specifies the number of directories in the path.
  38.  
  39.           _n_p_a_t_h_s__r_e_t_u_r_n
  40.                     Returns the number of strings in the font path
  41.                     array.
  42.  
  43.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  44.           The _X_S_e_t_F_o_n_t_P_a_t_h function defines the directory search path
  45.           for font lookup.  There is only one search path per X
  46.           server, not one per client.  The encoding and interpretation
  47.           of the strings are implementation-dependent, but typically
  48.           they specify directories or font servers to be searched in
  49.           the order listed.  An X server is permitted to cache font
  50.           information internally; for example, it might cache an
  51.           entire font from a file and not check on subsequent opens of
  52.           that font to see if the underlying font file has changed.
  53.           However, when the font path is changed, the X server is
  54.           guaranteed to flush all cached information about fonts for
  55.           which there currently are no explicit resource IDs
  56.           allocated.  The meaning of an error from this request is
  57.           implementation-dependent.
  58.  
  59.           _X_S_e_t_F_o_n_t_P_a_t_h can generate a _B_a_d_V_a_l_u_e error.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSeeeettttFFFFoooonnnnttttPPPPaaaatttthhhh((((3333XXXX11111111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))  XXXXSSSSeeeettttFFFFoooonnnnttttPPPPaaaatttthhhh((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           The _X_G_e_t_F_o_n_t_P_a_t_h function allocates and returns an array of
  75.           strings containing the search path.  The contents of these
  76.           strings are implementation-dependent and are not intended to
  77.           be interpreted by client applications.  When it is no longer
  78.           needed, the data in the font path should be freed by using
  79.           _X_F_r_e_e_F_o_n_t_P_a_t_h.
  80.  
  81.           The _X_F_r_e_e_F_o_n_t_P_a_t_h function frees the data allocated by
  82.           _X_G_e_t_F_o_n_t_P_a_t_h.
  83.  
  84.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  85.           _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of
  86.                     values accepted by the request.  Unless a specific
  87.                     range is specified for an argument, the full range
  88.                     defined by the argument's type is accepted.  Any
  89.                     argument defined as a set of alternatives can
  90.                     generate this error.
  91.  
  92.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  93.           XListFont(3X11), XLoadFonts(3X11)
  94.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.